home *** CD-ROM | disk | FTP | other *** search
/ SGI Varsity Update 1998 August / SGI Varsity Update 1998 August.iso / dist / dist6.4 / pvm.idb / usr / share / catman / u_man / cat1 / pvm.z / pvm
Text File  |  1998-07-29  |  8KB  |  189 lines
  1. PVM(1)                                                 Last changed: 5-8-98
  2.  
  3.  
  4. NNAAMMEE
  5.      ppvvmm - Starts the Parallel Virtual Machine (PVM) console
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ppvvmm [_o_p_t_i_o_n_s] [_h_o_s_t_f_i_l_e]
  9.  
  10. IIMMPPLLEEMMEENNTTAATTIIOONN
  11.      UNICOS, UNICOS/mk, and IRIX systems
  12.  
  13.      Cray Research and Silicon Graphics offer two release packages that
  14.      include PVM libraries; they are referred to as the CRAY T3D version
  15.      and the MPT version.  For more information about the MPT version, see
  16.      the _M_e_s_s_a_g_e _P_a_s_s_i_n_g _T_o_o_l_k_i_t:  _P_V_M _P_r_o_g_r_a_m_m_e_r'_s _M_a_n_u_a_l, publication SR-
  17.      2196.
  18.  
  19.      This command is not available in the following release packages:
  20.  
  21.           CRAY T3D version
  22.  
  23.           MPT version in stand-alone mode
  24.  
  25. DDEESSCCRRIIPPTTIIOONN
  26.      The ppvvmm command starts the Parallel Virtual Machine (PVM) console.
  27.      This stand-alone PVM task enables you to interactively query and
  28.      modify the virtual machine.  The console can be started and stopped
  29.      multiple times on any of the systems in the virtual machine without
  30.      affecting PVM or any applications that may be running.
  31.  
  32.      When you start the PVM console, it determines if PVM is already
  33.      running and, if PVM is not running, it automatically executes ppvvmmdd33(1)
  34.      on this system, and passes the PVM daemon the command line options and
  35.      host file.
  36.  
  37.      The ppvvmm command accepts the following arguments:
  38.  
  39.      _o_p_t_i_o_n_s        Specifies options to be passed to the PVM daemon.  For
  40.                     a list of options, see the ppvvmmdd33(1) man page.
  41.  
  42.      _h_o_s_t_f_i_l_e       Specifies the host file to be passed to the PVM daemon.
  43.                     For host file and option information, see the ppvvmmdd33(1)
  44.                     man page.
  45.  
  46.      Once started, the console displays the following prompt:
  47.  
  48.           pvm>
  49.  
  50.      The following console commands are available.  For syntax and option
  51.      information, enter the console hheellpp command.
  52.  
  53.      aadddd            Adds the systems specified after the command to the
  54.                     virtual machine.
  55.  
  56.      aalliiaass          Defines or lists console command aliases.
  57.  
  58.      ccoonnff           Lists the PVM system configuration.
  59.  
  60.      ddeelleettee         Deletes the systems specified after the command from
  61.                     the virtual machine.  PVM processes that are still
  62.                     running on the systems are lost.
  63.  
  64.      eecchhoo           Echoes arguments.
  65.  
  66.      hhaalltt           Kills all PVM processes and shuts down PVM.  All
  67.                     daemons exit.  This is the best way to exit the console
  68.                     if you are done using PVM.  See qquuiitt.
  69.  
  70.      hheellpp           Provides minimal information about the commands.  If
  71.                     you enter hheellpp followed by a command name, a brief
  72.                     description of the syntax is displayed.
  73.  
  74.      iidd             Prints the task ID of the console.  (The console is
  75.                     simply another PVM task.)
  76.  
  77.      jjoobbss           Displays a list of running jobs.  The --ll option
  78.                     provides more detailed output.
  79.  
  80.      kkiillll           Kills a PVM user process.
  81.  
  82.      mmssttaatt          Gives status for each system listed.
  83.  
  84.      ppss             Gives a listing of current processes and their status.
  85.  
  86.      ppssttaatt          Displays the status of a single PVM process.
  87.  
  88.      qquuiitt (or EOF)  Exits the console, but leaves the daemons and processes
  89.                     running.  See hhaalltt.
  90.  
  91.      rreesseett          Resets the virtual machine.
  92.  
  93.      sseetteennvv         Displays or sets environment variables.
  94.  
  95.      ssiigg            Sends signal to tasks.
  96.  
  97.      ssppaawwnn          Starts a PVM application.
  98.  
  99.      ttrraaccee          Sets or displays trace event mask.
  100.  
  101.      uunnaalliiaass        Undefines command alias.
  102.  
  103.      vveerrssiioonn        Shows lliibbppvvmm version.
  104.  
  105. EEXXAAMMPPLLEESS
  106.      On UNICOS and UNICOS/mk systems, use of MPT requires the Cray
  107.      Programming Environment 3.0 releases or later, and requires use of
  108.      Modules software.  Use the Modules software package to install both
  109.      the Programming Environment and MPT.  To use MPT software, load the
  110.      mmpptt module in addition to loading the Programming Environment module.
  111.      For information on using modules, see _I_n_s_t_a_l_l_i_n_g _P_r_o_g_r_a_m_m_i_n_g
  112.      _E_n_v_i_r_o_n_m_e_n_t _P_r_o_d_u_c_t_s, publication SG-5191, or if the Programming
  113.      Environment has already been installed on your system, see the online
  114.      ASCII file, //oopptt//ccttll//ddoocc//RREEAADDMMEE.  After you have initialized modules,
  115.      to access the MPT software, enter the following command:
  116.  
  117.           module load mpt
  118.  
  119.      When you use the MPT version of PVM, $$PPVVMM__RROOOOTT and $$PPVVMM__AARRCCHH are set
  120.      automatically for you when the mmpptt module is loaded.
  121.  
  122.      On IRIX systems, the use of Modules software is optional.  However,
  123.      even without modules, IRIX users can use the examples shown in this
  124.      subsection by setting the following environment variables:
  125.  
  126.      * If PVM is installed in a standard location, set PPVVMM__RROOOOTT to
  127.        //uussrr//aarrrraayy//PPVVMM.  Otherwise, use the appropriate value.
  128.  
  129.      * Set PPVVMM__AARRCCHH to the appropriate architecture type (see the
  130.        ppvvmm__iinnttrroo(1) man page).
  131.  
  132.      * Add $$PPVVMM__RROOOOTT//lliibb and $$PPVVMM__RROOOOTT//bbiinn//$$PPVVMM__AARRCCHH to the PPAATTHH
  133.        environment variable.
  134.  
  135.      The following examples show how to use the ppvvmm command after the mmpptt
  136.      module has been loaded or, for IRIX users, after the appropriate
  137.      environment variables have been set.
  138.  
  139.      Example 1:  Enter the following to start the PVM daemon on your local
  140.      system or to connect to a running PVM daemon.
  141.  
  142.           pvm
  143.  
  144.      Example 2:  Enter the ppvvmm command with a host file name to start the
  145.      console and the PVM daemon.  The daemon reads the file and adds the
  146.      listed computers to the virtual machine.
  147.  
  148.           pvm _h_o_s_t_f_i_l_e
  149.  
  150.      Example 3:  You can put entries like the following in your
  151.      $$HHOOMMEE//..ppvvmmrrcc file because ppvvmm reads this file before it reads commands
  152.      entered interactively.
  153.  
  154.               alias ? help
  155.               alias h help
  156.               alias j jobs
  157.               setenv PVM_EXPORT DISPLAY
  158.               # print my id
  159.               echo new pvm shell
  160.               id
  161.  
  162.      Example 4:  The user requested ssppaawwnn syntax and option information by
  163.      entering hheellpp and the command name.
  164.  
  165.           pvm> hheellpp ssppaawwnn
  166.           SPAWN  - Spawn task
  167.           Syntax:  spawn [ options ] file [ arg ... ]
  168.           Options:  -(count)  number of tasks, default is 1
  169.                     -(host)   spawn on host, default is any
  170.                     -(ARCH)   spawn on hosts of ARCH
  171.                     -?        enable debugging
  172.                     ->        redirect output of job to console
  173.                     ->(file)  redirect output of job to file
  174.                     ->>(file) append output of job to file
  175.  
  176. FFIILLEESS
  177.      $$HHOOMMEE//..ppvvmmrrcc                  Command file read when the ppvvmm command
  178.                                    starts up
  179.  
  180.      $$PPVVMM__RROOOOTT//lliibb//ppvvmmdd33           PVM daemon executable file started by
  181.                                    the ppvvmm command (if already running)
  182.  
  183. SSEEEE AALLSSOO
  184.      ppvvmm__iinnttrroo(1), ppvvmmdd33(1)
  185.  
  186.      _M_e_s_s_a_g_e _P_a_s_s_i_n_g _T_o_o_l_k_i_t:  _P_V_M _P_r_o_g_r_a_m_m_e_r'_s _M_a_n_u_a_l, publication SR-2196
  187.  
  188.      This man page is available only online.
  189.